home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / wcff_300.zip / WCFLFWRD.DOC < prev    next >
Text File  |  1991-08-01  |  17KB  |  457 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                      A WILDCAT! BBS FILE FORWARD UTILITY
  23.  
  24.                                    WCFLFWRD
  25.  
  26.                                 Version  3.00
  27.  
  28.  
  29.                 (C) COPYRIGHT  1989, 1991 - All Rights Reserved
  30.  
  31.                                       by
  32.  
  33.                            Online Computer Resources
  34.                               4330-J Clayton Road
  35.                              Concord,  CA.   94521
  36.  
  37.                             Voice #  (415) 687-1122
  38.  
  39.                             Data  #  (415) 687-0236
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59. WILDCAT! is copyrighted by MUSTANG SOFTWARE, Bakersfield, CA  93301-3118
  60.  
  61.  
  62.  
  63. SHAREWARE POLICY
  64. ----------------
  65.  
  66. WCFLFWRD (Version 3.00) is distributed under the Shareware concept.  You
  67. are granted a 30 day license to use and share it under the following
  68. conditions:
  69.  
  70.       o  WCFLFWRD is not distributed in a modified form.
  71.       o  No fee is charged for WCFLFWRD itself.
  72.       o  The registered version of WCFLFWRD is not distributed.
  73.       o  All references to the copyright and author are retained.
  74.  
  75. The latest version of WCFLFWRD is available on the support BBS number
  76. listed on the cover page.  If you register WCFLFWRD, you will get the
  77. latest full version of WCFLFWRD, program support, notification of
  78. updates and be able to download the updates from the support BBS listed
  79. in the update notification.  Registration costs $25.  Please see the order
  80. form called REGISTER.DOC.
  81.  
  82. If you use WCFLFWRD for longer than 30 days you will be in violation of
  83. this licensing agreement.
  84.  
  85.  
  86. SYSTEM REQUIREMENTS
  87. -------------------
  88.  
  89. WCFLFWRD is fully aware of most network systems (Novell, Lantastic etc.)
  90. IBM or compatible computer
  91. Mono/CGA/EGA/VGA Display
  92. WILDCAT! BBS v3.00 only           ******* VERY IMPORTANT *******
  93. D'Bridge/Binkley/FrontDoor/Dutchie/Seadog etc... mailers
  94.  
  95.  
  96.  
  97.  
  98. LIMITED WARRANTY
  99. ----------------
  100.  
  101. This program is provided "AS IS" without warranty of any kind.  Either
  102. expressed or implied, including but not limited to the implied warranties
  103. of merchantability and fitness for a particular purpose with respect to
  104. defects in the program or documentation.  The author, Online Computer
  105. Resources, assumes no risk as to quality and performance of the program.
  106. Should it prove defective, you assume the entire cost of any loss of
  107. profit or other commercial damage.  Some states do not allow the
  108. exclusion of warranties, so the above exclusion may not apply to you.
  109.  
  110.  
  111.  
  112. COPYRIGHT
  113. ---------
  114.  
  115. Regardless of the method of marketing used, WCFLFWRD is NOT in the
  116. "Public Domain".  It is copyrighted by Online Computer Resources.
  117.  
  118.  
  119.  
  120. WHAT IS WCFLFWRD?
  121. -----------------
  122.  
  123. WCFLFWRD is a Fidonet utility program to import files into your system,
  124. and to export or forward files to other systems based on a distribution
  125. scheme much like echomail is imported into or exported from your Fidonet
  126. system.  WCFLFWRD is the equivalent to FLEA and TICK, except that it is
  127. specific to Wildcat! and will not operate on any other type of BBS
  128. system.  It is totally compatible with both FLEA and TICK, and as such
  129. can read in FLE and TIC files with no problems.  The files exported are
  130. put in the TIC format, and adhere to the specifications as layed out by
  131. Barry Geller (author of TICK).  Outgoing files may be created in the FLE
  132. format and adhere to those standards as layed out by Ron Bemis.  If you
  133. are familiar with echomail, then WCFLFWRD is equivalent to the import/
  134. export or toss/scan routines in echomail.
  135.  
  136.  
  137. HOW DOES WCFLFWRD WORK?
  138. -----------------------
  139.  
  140. The first thing WCFLFWRD does, is check to see whether the WCFLFWRD.CFG
  141. file is present in the current sub-directory, reads it and stores the
  142. information.  If the WCFLFWRD.CFG file is not present the program stops
  143. processing.   The WCFLFWRD.CFG file tells WCFLFWRD where to find certain
  144. areas or files on your system, and also specifies all the different file
  145. areas you will be receiving/forwarding from your system.  WCFLFWRD then
  146. reads the Wildcat! CONFIGWC.BBS file from the location you specified in
  147. the WCFLFWRD.CFG file.  Again, if it can't find the file it will stop
  148. processing.  From the CONFIGWC.BBS file, WCFLFWRD gets the location of
  149. the data files, the location of all your file areas, and then initializes
  150. the datafiles so that it can process them.  By initializing, we mean that
  151. it prepares them for use in a multi-line or single-line environment,
  152. depending on your selection in the CONFIGWC.BBS file, ie.  MAKEWILD
  153. settings.  This means that WCFLFWRD will run without any problems while
  154. another node (if multi-line is used) is operating.
  155.  
  156. Now, WCFLFWRD goes to work.  It reads the INBOUND files directory that
  157. you specified in the WCFLFWRD.CFG and looks for all FLE and TIC files.
  158. Each FLE and TIC file is read, and the file is added to the Wildcat!
  159. file database and if necessary is forwarded on to any other nodes that
  160. you may have specified.  If the file already exists in Wildcat!, it is
  161. ignored and the next FLE or TIC file is processed.  This process is
  162. repeated until such time as all incoming FLE or TIC files are processed.
  163. All activity is logged fully in the WCFLFWRD.LOG file, so that if any
  164. problems are encountered, a note is made in the LOG file.  The LOG file
  165. contains a comprehensive audit trail of the activity, so please check it
  166. over carefully.
  167.  
  168. That, in a nutshell, is how WCFLFWRD works.  A more detailed description
  169. appears in the section "RUNNING WCFLFWRD".
  170.  
  171.  
  172.  
  173.  
  174.  
  175. INSTALLING WCFLFWRD
  176. -------------------
  177.  
  178. Copy the WCFLFWRD.EXE and WCFLFWRD.CFG files to your mailer sub-directory.
  179. Edit the WCFLFWRD.CFG file so that it conforms to your system.  The CFG
  180. file must contain the following information.  You MUST use blank lines to
  181. seperate each FILEAREA.  Upper or lower case is not a factor, so you can
  182. type the information in any case.  An example of the WCFLFWRD.CFG file
  183. follows:
  184.  
  185. ORIGZONE 1
  186. NETNODE 161/502
  187. AKA 1:161/0
  188. AKA 1:161/500
  189. WILDCAT f:\wildcat!\node3
  190. INFILES f:\db\files
  191. OUTFILES f:\db
  192. FIDO/SEADOG                or         OPUS/BINKLEY
  193. NETMAIL f:\db\messages     or         OUTBOUND f:\binkley\outbound
  194. ZONE
  195. CRC
  196. FILEAREA 3 TICK
  197.          1:161/505 pass1 *
  198.          1:161/506 pass2 *&F
  199.          1:161/501 pass3 C
  200.          1:161/2 one *F
  201.          1:161/7 two *
  202.  
  203. FILEAREA 4 BINKLEY
  204.   1:161/505 pass1 *
  205.  
  206. FILEAREA 5 OPUS
  207.   1:105/3 password *
  208.  
  209.  
  210. A description of the WCFLFWRD.CFG follows:
  211.  
  212. ORIGZONE 1
  213.         This is your zone number.  WCFLFWRD is zone aware.  Do *not*
  214.         leave this out.
  215.  
  216. NETNODE 1:161/502
  217.         This is your net/node number.
  218.  
  219. AKA 1:161/0
  220.         This is your alias address.  If you have more than one alias,
  221.         then you should create a new AKA line for each alias that you
  222.         have.
  223.  
  224. WILDCAT f:\wildcat!\node3
  225.         This is the directory name of your Wildcat! configuration file,
  226.         CONFIGWC.BBS.  If you are running multi-node,  then this can
  227.         be any of your nodes configuration files.  The example above
  228.         uses NODE 3's configuration file.
  229.  
  230. INFILES f:\db\files
  231.         This is the directory name where all your inbound files reside.
  232.  
  233. OUTFILES f:\db
  234.          This is the directory name of your outbound files directory.
  235.          In 99.9% of the time, this is your main mailer location.
  236.          WCFLFWRD will copy the files to be sent and put them here, and
  237.          will also create the outgoing FLE file in this directory.
  238.  
  239.  
  240.  
  241. FIDO/SEADOG
  242.             This tells WCFLFWRD to operate in the Fido/Seadog mode, and
  243.             it will create netmail messages with file attaches.  If you
  244.             select this mode, then the NETMAIL option MUST be specified
  245.             showing the location of your netmail directory.  If the
  246.             NETMAIL option is omitted, WCFLFWRD will not work.  If you
  247.             D'Bridge or Frontdoor, you must use this option.
  248.  
  249. OPUS/BINKLEY
  250.              This tells WCFLFWRD to operate in the Opus/Binkley mode, and
  251.              it will create FLO files in the directory you specified in
  252.              the OUTBOUND optiom.  The OUTBOUND option MUST be specified
  253.              showing the location of your outbound directory.  If the
  254.              OUTBOUND option is omitted, WCFLFWRD will not work.
  255.  
  256. NETMAIL f:\db\messages
  257.         This option gives the location of the netmail directory.  This
  258.         option must be used if the FIDO/SEADOG mode is selected.
  259.  
  260. ZONE
  261.       This option tells WCFLFWRD to support Zones.  The default setting
  262.       is NO ZONE support.  This is to make it compatible with Flea (c).
  263.       For true zone support, this option must be used.
  264.  
  265. CRC
  266.       This option tells WCFLFWRD to check the CRC-32 of all incoming files.
  267.       If CRC is in the CFG file, and the incoming file fails the CRC, then
  268.       the incoming .TIC file is renamed to a .BAD file.  If the CRC is not
  269.       found in the CFG file, then the CRC is not checked, but all outgoing
  270.       .TIC files created by WCFLFWRd will have the correct calculated CRC
  271.       value in them.
  272.  
  273. OUTBOUND f:\binkley\outbound
  274.          This option gives the location of the outbound directory.  This
  275.          option must be used if the OPUS/BINKLEY mode is selected.
  276.  
  277.  
  278.  
  279.  
  280. FILEAREA 2 TICK
  281.          1:161/505 pass1 *
  282.          1:161/506 pass2 &
  283.          This is the line which tell WCFLFWRD which areas you will import
  284.          or export.  The "2" is the numeric File Area you have
  285.          specified in the Wildcat! configuration, and TICK is the name
  286.          of the FILEAREA you will be processing.  Only file areas "1"
  287.          thru "999" are valid, and the area name must be a valid area in
  288.          the SDS distribution system.  Following this statement is a
  289.          list of all the nodes which you will send the file to, as
  290.          well as their passwords.  It also contains the list of nodes
  291.          that send files to you and their passwords too.  The character(s)
  292.          after the password have a special meaning and are described as
  293.          follows:
  294.  
  295.              *   -  Files from this node will be accepted.  If not
  296.                     present, files can be sent to the node, but no files
  297.                     will be accepted from them.
  298.              &   -  Files will not be sent to this node.  If this is the
  299.                     only flag for this node, then this node has effectively
  300.                     been commented out, and no files will be received or
  301.                     sent to this node.  If you specify a "*" with this flag
  302.                     then you will accept files from this system, but no
  303.                     files will be sent to it.
  304.              C   -  CRASH files will be generated for this node (a CLO
  305.                     in Opus/Binkley mode)
  306.              H   -  File is put in HOLD status for this node (a HLO
  307.                     in Opus/Binkley mode)
  308.              F   -  FLE files will be created for this node instead of
  309.                     sending TIC files.
  310.  
  311.           There *MUST* be a BLANK line between FILEAREA statements, and
  312.           there can be a maximum of 40 FILEAREA statements in the CFG
  313.           file.  There is also a limitation of 50 net/node numbers that
  314.           you can specify for each FILEAREA.  Passwords are limited to
  315.           8 characters in length, and file area names can be 10 characters
  316.           long.
  317.  
  318.  
  319.  
  320. RUNNING WCFLFWRD
  321. ----------------
  322.  
  323. WCFLFWRD can be run anytime outside of Wildcat! and will forward files
  324. to those nodes that are in the requested area, and will add the file to
  325. the Wildcat! file database.  To understand WCFLFWRD better, a short
  326. description of a FLE or TIC file is needed.  Basically, a FLE file looks
  327. like the following:
  328.  
  329. Area: tick
  330. Test.zip
  331. This is a test of the tick file area
  332. Origin: 161/505
  333. From: 161/506 pass2
  334. Created by WCFLFWRD v1.02 Copyright 1989 by Online Computer Resources
  335. Seenby 161/505 *
  336. Seenby 161/506 *
  337.  
  338. The Area: line associates this file with the TICK file area.  Following
  339. this line is the name of the file, and the description of the file.  A
  340. log of where the file originated and the path it has followed is also
  341. included in the FLE file.  As can be seen from the above example, this
  342. file (TEST.ZIP), originated on 161/505 and was sent to me by 161/506 with
  343. the password of PASS2.  The Seenby lines denote which systems have actually
  344. seen this file, and the "*" after the net/node number tells us the path
  345. this file actually took before getting to this node.
  346.  
  347. WCFLFWRD reads this FLE file and copies the file to the respective
  348. Wildcat! file area ("A" in the WCFLFWRD.CFG example) and adds it to the
  349. Wildcat! database.  It then creates an outbound FLE file for each node
  350. specified in your WCFLFWRD.CFG that has NOT seen this file.  It creates
  351. a netmail message or FLO file depending on which mode you selected.  After
  352. all FLE files have been created the inbound FLE is then deleted, and the
  353. next FLE file is read, and the whole process is repeated.
  354.  
  355.  
  356. COMMAND LINE ARGUMENTS/SWITCHES
  357. -------------------------------
  358.  
  359. WCFLFWRD <-N> <-T>
  360.  
  361. The <..> signifies that this is an optional field.  The valid command
  362. line switches are as follows:
  363.  
  364.   -N   -   WCFLFWRD will clean up after itself when it is finished
  365.            running.  It will scan through all the outgoing .TIC files,
  366.            and those .TIC's that do not have corresponding .MSG's will
  367.            be deleted.  The -N option disables this feature, and you,
  368.            the sysop, will have to manually delete all the outbound
  369.            .TIC files.  This will only work in the FIDO/SEADOG mode!
  370.  
  371.   -T   -   WCFLFWRD will truncate (delete) outbound files attaches in
  372.            the OPUS/BINKLEY mode with this switch.  Please bear in mind
  373.            that v1.00 of WCFLFWRD truncated (deleted) the outbound files
  374.            automatically.  This reverses the process, and forces you,
  375.            the sysop, to tell WCFLFWRD to truncate (delete) the files
  376.            after they have been sent.  This will only work in the
  377.            OPUS/BINKLEY mode!
  378.  
  379.  
  380.  
  381. REQUIREMENTS/LIMITATIONS OF WCFLFWRD
  382. ------------------------------------
  383.  
  384. 1.  Pre-Releases are not supported yet.
  385. 2.  You can have different passwords for the same node for different
  386.     FILEAREA's, and the password must be less than or equal to 8 characters
  387.     in length.
  388. 3.  Area names are limited to 10 characters in length.
  389. 4.  Try to keep all your directories that you specify in the WCFLFWRD.CFG
  390.     file to the same drive.  WCFLFWRD will rename the file if it is on
  391.     the same drive, and will copy and then delete the file if on different
  392.     drives.  It is much faster to rename than it is to copy and delete!
  393. 5.  Points are not supported in this version.  They may work, but I
  394.     haven't tested it.
  395. 6.  Upper or lower case is not a problem.  You can specify any case!
  396. 7.  If you want to support Zones, make sure you specify ZONE in the CFG
  397.     file.
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404. Future enhancements to be provided for WCFLFWRD are:
  405.  
  406.     o   Support Pre-Releases of files
  407.     o   Support points
  408.     o   Any suggestions?
  409.  
  410.  
  411.  
  412.  
  413. TECHNICAL SUPPORT
  414. -----------------
  415.  
  416. Comments and suggestions about WCFLFWRD are welcome, as well as any
  417. comments or suggestions that you may have or want in terms of additional
  418. utilities that you want to see written.  Please call Online Computer
  419. Resources at 415-687-1122 (during business hours - 9am to 6pm PST) or
  420. we can be reached on Fidonet 161/503, Mustang Software's Support BBS,
  421. or at the following Online Computer Resource BBS:
  422.  
  423.         The File Server   - (415) 687-0236  3/12/24/96  DS/HST/V32/V42
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430. Revision History
  431. ----------------
  432.  
  433. 06-15-90  v1.00   -   General release of WCFLFWRD
  434.  
  435. 09-15-90  v1.01   -   Added two command line switches.
  436.                       -N to not delete .TIC's after WCFLFWRD finishes.
  437.                       -T to truncate files after they have been sent.
  438.                       The -T is for Binkleyterm/Opus use only.  The
  439.                       v1.00 default was to truncate files, and this
  440.                       version changes that.  Please read the documentation
  441.                       above.
  442.  
  443. 01-01-91  v1.02   -   Added CRC-32 checking on incoming TIC files.
  444.                       A new WCFLFWRD.CFG option of "CRC" will cause
  445.                       WCFLFWRD to check the incoming file for a valid
  446.                       CRC-32.  If it fails the CRC, the file is not
  447.                       processed and the incoming .TIC file is renamed
  448.                       to .BAD.  All outbound TIC files will have the
  449.                       correct CRC value in them, regardless of whether
  450.                       you have CRC in the CFG file or not.  TABS are
  451.                       now ignored in the WCFLFWRD.CFG file.
  452.  
  453. 08-01-91 v3.0     -   1st release of WCFLFWRD v3.0 compatible with
  454.                       WILDCAT! v3.00
  455.  
  456.  
  457.